home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / misc / demo / clips.sit / Read Me < prev    next >
Encoding:
Text File  |  1988-05-10  |  8.3 KB  |  196 lines
  1.                         CLIPS Release Notes
  2.  
  3.                   Version 4.2     April 29, 1988
  4.  
  5. This file contains any last minute information pertaining to this
  6. version of CLIPS that was not included in the Reference Manual. It
  7. also contains information of general use about CLIPS, such as where
  8. to report problems, how to get CLIPS, and a description of any known
  9. problems with the documentation or program.
  10.  
  11.  
  12. DISTRIBUTION DISKS
  13. ------------------
  14. If you received CLIPS on MS_DOS floppy disks, you should have
  15. received seven 360K disks. The essential contents of each disk is
  16. listed below:
  17.  
  18. Executables 1 - Main CLIPS executable, CRSV executable,and this
  19.                          file
  20.  
  21. Executables 2 - Example programs, on-line help file, and
  22.                          generator demo
  23.  
  24. Source Code 1 - CLIPS source code
  25.  
  26. Source Code 2 - CLIPS source code
  27.  
  28. Source Code 3 - CLIPS source code
  29.  
  30. Utilities 1   - CRSV source code
  31.  
  32. Utilities 2   - CLIPS with PC Mouse/Window interface and source
  33.  
  34. If you received CLIPS on Macintosh floppy disks, you should have
  35. received three 800K disks. The essential contents of each disk is
  36. listed below:
  37.  
  38. Executables - Main CLIPS executable, CRSV executable, Macintosh
  39.                       interface executable, this file, example programs, and 
  40.                       the EMACS editor source code
  41.  
  42. Source Code - CLIPS source code
  43.  
  44. Utilities      - CRSV source code, Macintosh interface code, and
  45.                       on-line help file
  46.  
  47.  
  48. HOW TO GET CLIPS
  49. ----------------
  50. CLIPS was developed by the Artificial Intelligence Section of the
  51. Mission Planning and Analysis Division at NASA/Johnson Space Center.
  52. CLIPS is available to NASA groups by calling the CLIPS Help Desk
  53. between the hours of 9:00 AM to 4:00 PM (CST) Monday through Friday
  54. at (713) 280-2233. NASA contractors should have their contract
  55. monitor call the CLIPS Help desk to obtain CLIPS.
  56.  
  57. CLIPS is available outside of NASA through COSMIC, the NASA software
  58. distribution center. The cost of CLIPS is about $350 for both source
  59. code and MS-DOS or Macintosh executable. Unlimited copies can be made
  60. after purchasing CLIPS through COSMIC. The same source code will run
  61. on nearly any machine which can support an ANSI or K&R C compiler.
  62. The COSMIC program number is MSC-21208. COSMIC can be contacted at:
  63.  
  64.      COSMIC
  65.      382 E. Broad St.
  66.      Athens, GA  30602
  67.      (404) 542-3265
  68.  
  69.  
  70. PROBLEMS INSTALLING OR USING CLIPS
  71. ----------------------------------
  72. CLIPS is not a commercial product, and is not supported to the extent
  73. that a commercial product normally would be. However, NASA employees
  74. can obtain some help with CLIPS problems by calling the CLIPS Help
  75. desk. The Help desk is available between the hours of 9:00 AM to 4:00
  76. PM (CST) Monday through Friday at (713) 280-2233. Callers should
  77. leave a description of their problem and a phone number and they will
  78. be contacted. Outside organizations should use the bug report forms
  79. included with the CLIPS documentation to report problems with CLIPS.
  80.  
  81.  
  82. WARNINGS, THINGS TO WATCH OUT FOR
  83. ---------------------------------
  84. The following section describes common problems users have with
  85. CLIPS, or things to be aware of when using CLIPS. If you are having
  86. unusual problems, check this section and the next one before
  87. reporting a bug.
  88.  
  89. 1) Using the integrated editor to edit large files and then execute
  90. them in CLIPS could cause severe memory problems on a PC. The editor
  91. itself does not take up all that much memory, but a large file of
  92. rules that is in the editor and then loaded into CLIPS could cause
  93. the machine to do any of three things; completely hang, exit to DOS
  94. with some kind of error message, or warn about memory failures and
  95. refuse to compile a rule or file. The moral is when working on a PC,
  96. use a PC with as much memory as possible, and avoid editing large
  97. files while in CLIPS. The Macintosh generally does not have 
  98. as severe a memory limitation for rules, however, the Macintosh editor 
  99. is limited to 32K files.
  100.  
  101. 2) Because of differences in machines, the allowable range of values
  102. a CLIPS number may have can vary. Particularly, the largest or
  103. smallest allowed value on one machine may cause floating point
  104. overflows on another.
  105.  
  106. 3) If errors occur while loading CLIPS rules, the system can be left
  107. in an inconsistent state. For example, if the new rule is supposed to
  108. replace an existing rule, after the error is found, neither rule
  109. exists, since the old rule is excised first. Other kinds of errors
  110. can be harder to detect. If errors occur while loading a rule, and
  111. subsequent actions don't appear to be working right or you get system
  112. error messages, it is best to exit CLIPS and start over.
  113.  
  114. 4) If a SYSTEM NET ERROR message ever occurs, it means that the
  115. pattern network has been "trashed" by some previous action (such as
  116. some kinds of rule loading errors). The only real solution to this
  117. problem is to exit CLIPS and reload all the rules.
  118.  
  119. 5) This version of CLIPS has an include file named memory.h. Some C
  120. compilers also have a system include file named memory.h. Although
  121. none of our systems have had a problem keeping the files separate,
  122. the possiblity exists. If you receive strange errors while compiling 
  123. CLIPS, try renaming the include file to clipsmem.h and altering all 
  124. CLIPS files which include it.
  125.  
  126. 6) For reasons we don't understand, VAX VMS will not allow the file
  127. edterm.obj to be placed in a library. If you intend to use the editor
  128. under VAX VMS, you must link directly with edterm.obj.
  129.  
  130. 7) The on-line help file is too large to fit on the same disk with the
  131. CLIPS executable. The default help-path setting expects to find this
  132. file in the same directory as the executable. Since it is distributed
  133. seperately, users may have to move the executable and the help file
  134. to a hard disk before the on-line help can be used.
  135.  
  136.  
  137. KNOWN PROBLEMS WITH CLIPS
  138. -------------------------
  139. The following section describes any known problems with CLIPS. Where
  140. possible, work arounds or fixes will also be described
  141.  
  142. 1) Typing a Control C at the top level of the CLIPS interactive
  143. interface on a PC will cause the program to go into an infinite loop.
  144. There is no good way to prevent this and still allow Control C to
  145. halt execution during rule firings. This is because of how CLIPS
  146. handles a keyboard interrupt. To recover from this error, the machine
  147. must be rebooted. The problem only occurs on MS-DOS based machines.
  148. It can be avoided by using the PC window interface.
  149.  
  150. 2) When using fprintout, printout or format to write to a file which
  151. will be used in a user-defined help system under VAX VMS, the very
  152. first character output to a new file seems to disappear. This only
  153. happens when writing to a new file, and only the very first character
  154. from the very first print call is lost. The problem only affects
  155. people who create user-defined help systems with CLIPS rules on a VMS
  156. system.
  157.  
  158. 3) CLIPS typically won't allow a single symbol or string longer than
  159. 512 characters. Under most cirumstances, if CLIPS finds to long a
  160. symbol or string, it prints an appropriate error message. However, if
  161. a user types in a string at the top level that is longer than 512
  162. characters, CLIPS may not handle it properly.
  163.  
  164. 4) When using the MicroEMACS editor under VAX VMS, the meta commands
  165. meta dot or meta backspace don't work.
  166.  
  167. 5) If CLIPS is compiled using Turbo C on an IBM PC, using the the
  168. control C command in the MicroEMACS editor causes the machine to
  169. hang.
  170.  
  171. 6) The rules-to-c function does not handle multi-line strings
  172. properly. They process OK during compilation, but will not execute
  173. properly. A multi-line string is any string which includes an
  174. embedded carriage return.
  175.  
  176. 7) Some trig functions in the extended math packages do not return
  177. correct values when used on a Macintosh under Lightspeed C. The
  178. functions are acos, asec, sech, and cosh. The problem appears to be
  179. due to a bug in the Lightspeed C math libraries.
  180.  
  181. DOCUMENTATION ERRORS
  182. --------------------
  183. This section describes any problems, errors, typos, etc. in the CLIPS
  184. documentation.
  185.  
  186. 1) In the Appendix for the CLIPS User's guide, there are three typos.
  187. On page 154, the <Meta-R> command should be <Meta>R and the <Meta-S>
  188. command should be <Meta>S. On page 156, the <Ctrl-X>C command should
  189. be <Ctrl-X-C>.
  190.  
  191. 2) The CURSES window example in Appendix B.4 of the Advanced
  192. Programming Guide will not work under VAX VMS. The VMS CURSES
  193. implementation is not compatible with UNIX implementations for single 
  194. key input.
  195.  
  196.